Dropdown button
Type
widget
Description
The dropdown button is a button which presents an option menu when clicked. By default the menu appears wherever the button is clicked. When the button is in 'split' mode, the side of the button with the icon has a separate hit area which shows the menu when clicked, and the rest of the button can be used for a separate action.
Children Properties
Message
| Name | Summary | Syntax |
|---|---|---|
| mouseUp | Sent when the mouse button is released after clicking the main button in split mode. | mouseUp pButton |
| mouseDown | Sent when the mouse button is pressed. | mouseDown pButton |
| menuPick | Sent when a menu item is chosen. | menuPick pChosenItem |
Property
| Name | Summary | Syntax |
|---|---|---|
| hoverColor | The hover color of the button. | set the hoverColor of <widget> to <Color> get the hoverColor of <widget> |
| hiliteColor | The color of the button when highlighted. | set the hiliteColor of <widget> to <Color> get the hiliteColor of <widget> |
| menuBackgroundColor | The background color of the menu | set the menuBackgroundColor of <widget> to <Color> get the menuBackgroundColor of <widget> |
| menuHiliteColor | The color of the menu selection. | set the menuHiliteColor of <widget> to <Color> get the menuHiliteColor of <widget> |
| textSize | The size of the button label | set the textSize of <widget> to tTextSize get the textSize of <widget> |
| roundedRadius | The radius of the button corners | set the roundedRadius of <widget> to pRoundedRadius get the roundedRadius of <widget> |
| iconSize | The size of the arrow icon of the button | set the iconSize of <widget> to pIconSize get the iconSize of <widget> |
| menuDirection | The menu direction of the popup | set the menuDirection of <widget> to menuDirection get the menuDirection of <widget> |
| mode | The mode style of the button | set the mode of <widget> to {"default" | "split"} get the mode of <widget> |
| menuTextColor | The color of the menu text. | set the menuTextColor of <widget> to <Color> get the menuTextColor of <widget> |
| label | The label of the button | set the label of <widget> to pLabel get the label of <widget> |
| menuText | The menu items of the popup | set the menuText of <widget> to <List> get the menuText of <widget> |
| backgroundColor | The color of the button. | set the backgroundColor of <widget> to <Color> get the backgroundColor of <widget> |
| rippleEffect | Whether to display a ripple effect when the button is clicked. | set the rippleEffect of <widget> to {true | false} get the rippleEffect of <widget> |
| textColor | The color of the button text. | set the textColor of <widget> to <Color> get the textColor of <widget> |
| themeData | The theme mappings of this widget | set the themeData of <widget> to {<array>} get the themeData of <widget> |
| menuHiliteTextColor | The color of the text of the menu selection. | set the menuHiliteTextColor of <widget> to <Color> get the menuHiliteTextColor of <widget> |